home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBK.ADF / Utility / DFC5.doc < prev    next >
Text File  |  1991-02-09  |  8KB  |  179 lines
  1.  
  2.                    DFC5 --- A disk formatter/copier
  3.  
  4.  
  5.               Written by Tom Rokicki & Sebastiano Vigna
  6.  
  7.  
  8. DFC5 is a new, exciting, general-purpose disk copier and formatter
  9. which we hope will meet the needs of a large number of Amiga users.
  10. This program is essentially a development of Tom Rokicki's previous
  11. DFC4 program:  the principle adopted has been to eliminate everything
  12. that wasn't absolutely necessary, to reduce the size of the program
  13. as much as possible, to squeeze every ounce of speed from the
  14. standard trackdisk.device through an utterly async design, and to
  15. incorporate a number of useful thrills such as voice, multiple passes
  16. copies and checksum for the RAM buffer.
  17.  
  18.  
  19. Main features:
  20.  
  21.  - DFC5 copies from/to any combination of Amiga drives.
  22.  
  23.  - DFC5 has a switchable 880K RAM buffer that allows for any number
  24. of duplicates while only reading the source disk once. The
  25. combination of destination drives can be changed at each pass.
  26.  
  27.  - DFC5 checksums the RAM buffer.  If some badly written program is
  28. trashing your memory, you are alerted.  Thus, buffered copies are as
  29. safe as direct copies.
  30.  
  31.  - DFC5 is smaller than 11.5K, and even on a 1 megabyte Amiga you
  32. should be able to do single-pass multiple copies.
  33.  
  34.  - DFC5 will automatically switch to multiple (2, 3, or 4) pass
  35. copies if there isn't enough memory for a full 880K buffer. This even
  36. allows for making multiple copies with multiple passes on any Amiga.
  37.  
  38.  - DFC5 starts from track 79---no more last-moment verify errors!
  39.  
  40.  - DFC5 lets you retry/skip any read, write or verify errors.
  41.  
  42.  - DFC5 is highly system-friendly.  Only drives actually used are
  43. inhibited, and the use of CPU time is negligible.
  44.  
  45.  - DFC5 is totally asynchronous, both in handling the disk and in the
  46. user interface; you can, for instance, turn verify on/off at any
  47. time, even while copying.
  48.  
  49.  - DFC5 has the option of incrementing the creation date of the copy
  50. so AmigaDOS doesn't get confused. If, however, the option is switched
  51. on and the disk in not an AmigaDOS disk, the user is alerted.
  52.  
  53.  - DFC5 can be activated many times, and each copy can do a different
  54. task; for instance you can copy from DF0: to DF1:, while formatting
  55. DF2:  and doing a multiple pass copy on DF3:!
  56.  
  57.  - DFC5 is faster than diskcopy---actually it pushes the use of the
  58. standard trackdisk.device to its limits (125 secs for a disk-to-disk
  59. copy).
  60.  
  61.  - DFC5 alerts the user with sound (and optionally voice) about the
  62. operations in progress---so you can really be doing something else!
  63.  
  64.  - DFC5 can format both OFS and FFS disks.
  65.  
  66.  
  67. To use DFC5, you have simply to click on its icon. You will see four
  68. rows of gadgets. The first one has at most one gadget selected: it's
  69. the source. The second one lets you select the destination drive(s).
  70. The third one contains the option gadgets. The fourth one contains
  71. the action gadgets. Notice that the Auto gadget is currently
  72. disabled; because of a bug in the 1.3 trackdisk.device, its
  73. implementation has been delayed to a 2.0-only version of the program.
  74.  
  75. Every gadget can be activated via mouse or via keyboard. The first
  76. row can be activated with 0,1,2,3, and the second one with 4,5,6,7.
  77. For the other gadgets, you can use the capital letter of its name.
  78. The only exception is FFS, which will be activated by N (New File
  79. System). F is already used for FORMAT. As a bonus, you can use Q or
  80. ESC to exit, instead of hitting the close gadget. Finally, you can
  81. use RETURN to start a copy operation---which means GO for a
  82. non-buffered copy, and REPEAT for a buffered copy (see below).
  83.  
  84.  
  85.  - VERIFY turns on and off verify at any time (you can also format
  86. without verifying)---but this is not recommended.
  87.  
  88.  - BUFFER allocates a buffer to make multiple copies. Once a buffer
  89. is allocated, you can select the same drive for source and
  90. destination, and you can select REPEAT to make another copy of the
  91. same disk without rereading the original.  If DFC5 can't allocate an
  92. 880K buffer, it will try to allocate one for 2, 3 or 4 passes copies,
  93. and will alert the user accordingly (if no buffer at all can be
  94. allocated, a warning is issued). To do multiple pass copies, GO a
  95. first time, REPEAT the first disk chunk for all the disks you need,
  96. GO another time to read another disk chunk etc.
  97.  
  98.  - TALK activates DFC5's abilities to give its status by voice.
  99. Currently only English is supported.
  100.  
  101.  - FFS enables the formatting of an FFS disk; for copying it is
  102. ignored.
  103.  
  104.  - DATE toggles on or off the slight change of the date of an
  105. AmigaDOS disk. This change is necessary so AmigaDOS can distinguish
  106. otherwise identical disks; if two truly identical disks are inserted
  107. in the drives, AmigaDOS gets confused and crashes. However, if for
  108. some reason you want a ``physical'' copy, you would turn off this
  109. option.
  110. A non-AmigaDOS disk copied with the DATE option on will generate a
  111. warning, since this option will probably subtly corrupt the disk.
  112. You have time to switch off the DATE option, if you want, until the
  113. progress bar is in the middle.
  114.  
  115.  - STOP will stop at any time any operation. Note that pressing STOP
  116. while a multiple pass copy buffer is allocated and no copy operation
  117. is running will reset the pass counter (i.e., you can start a fresh
  118. new copy).
  119.  
  120.  - GO copies from the source to the destination if BUFFER is switched
  121. off, or copies from the source to the buffer if BUFFER is switched
  122. on.
  123.  
  124.  - REPEAT works only with the buffer, and writes it to all
  125. destinations. Note that when the buffer is on, you can select the
  126. same drive both in the source row and in the destination row. This
  127. allows, for instance, to read a source from df0: and then write it to
  128. both df0: and df1:.
  129.  
  130.  - FORMAT formats all destination drives. If VERIFY is selected, the
  131. process is verified.
  132.  
  133. DFC5 will issue requesters if it finds an error on read, write, or
  134. verify. You can ask to retry the operation or you can choose that you
  135. don't want to bother yourself with it. If you want to stop, it's
  136. usually better to first press the STOP gadget and then cancel the
  137. requester, or another requester might be issued between the two
  138. operations. Note that errors from the Unit 4 are checksum errors of
  139. the RAM buffer.
  140.  
  141. Because of a bug in the 1.3 trackdisk.device, a track with an error
  142. on a sector in it might be read completely wrong, yielding incorrect
  143. data even on the good sectors.
  144.  
  145. Please note that you have absolute freedom in the use of the RAM
  146. buffer: this means some more care, too. For instance, if while doing
  147. multiple pass copies you STOP two times, the pass counter will be
  148. reset. But if you hit REPEAT at this time (before reading a new chunk
  149. with GO), DFC5 will write on what it thinks is the ``last pass
  150. read'', i.e., the last chunk of disk, even if this wasn't actually
  151. the last piece of disk read. If you STOP while you're reading into
  152. the buffer, DFC5 will not increase the pass counter, since it thinks
  153. you have put in the wrong disk or something like that. This means
  154. also that REPEATing at this time will write on the previous disk
  155. chunk, with the first tracks probably trashed by the stopped GO
  156. operation. So be careful. A more restrictive mechanism will be
  157. implemented in the 2.0-only release.
  158.  
  159. The progress bar is drawn in a different color if you're doing a GO
  160. for a buffered operation---so you can be sure you read the new chunk
  161. in the buffer. Note also that the progress bar is not updated if
  162. something locked the screen (like using menus). The update is delayed
  163. until the screen is unlocked (thus DFC5 won't get stuck as will
  164. almost all programs which do any rendering to their windows).
  165.  
  166. This program is in the public domain; anyone can do anything they
  167. want with it. This software is made available on an as-is basis;
  168. don't come to us if you destroy your entire fish disk library with
  169. it! Of course, it was tested rather extensively before it was
  170. released . . .
  171.  
  172. Comments, complaints, desiderata are welcome.
  173.  
  174.  
  175.                 Tomas Rokicki                   Sebastiano Vigna
  176.                 Box 2081                        BIX: svigna
  177.                 Stanford, CA 94309.             Via Valparaiso, 18
  178.                 U.S.A.                          I-20144 Milano ITALY
  179.